home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
CD ROM Paradise Collection 4
/
CD ROM Paradise Collection 4 1995 Nov.iso
/
database
/
arv134e.zip
/
ARV.DOK
< prev
next >
Wrap
Text File
|
1995-02-06
|
131KB
|
3,535 lines
@
▄█ ██████████████▄ ███████ ▄███████▀
▄███ ████████████████ ███████ ▄███████▀
▄█████ ▀▀▀▀▀▀▀▀▀████████ ███████ ▄███████▀
▄███████ ███████ ███████▄███████▀
▄█████████ ▄██████ █████████████▀
▄███████████ ██████████████▀ ███████████▀
▄█████████████ ██████████████▄ █████████▀
▄███████▀███████ ▀▀▀▀▀▀▀▀▀███████ ███████▀
▄███████▀ ███████ ███████ █████▀
▄███████▀ ███████ ███████ ███▀
▄███████▀ ███████ ███████ █▀
The Archiver
Version 1.34
BE SURE TO READ SECTION 6. AND 8. BEFORE STARTING ARV !
All changes to the last version are marked with three asterisks,
***, you can easily search for it.
---------------------------------------------------------------------------
ARV -1- (c) Dirk Wriedt '91-'94
┌─────────────────────────────────────────────────────────────────────────┐
│ Contents │
└─────────────────────────────────────────────────────────────────────────┘
1. Introduction
1.5. Installation
2. Description of the different displays
3. ARV and 4DOS
4. The "swapping files" function
5. Some notes
6. Configuration files
7. The environment variables ARV & ARVRES
8. License agreements / Thanks
9. Making a registered version
10. Arv partitions
11. The programs ARV_OPTI and ARV_SOS
12. Questions & Answers
13. Error codes and descriptions
14. Command line options
15. System requirements
---------------------------------------------------------------------------
ARV -2- (c) Dirk Wriedt '91-'94
┌─────────────────────────────────────────────────────────────────────────┐
│ 1. Introduction │
└─────────────────────────────────────────────────────────────────────────┘
ARV is a file database program. It can be used to organize the usual mess
of tools, documents, small games, graphics, pascal sources, lists, etc.
ARV is no real database where one must enter the disk number of every file
and other stuff like date, comment etc., but ARV handles this on its own.
ARV has to be installed on hard disk.
The problem:
============
You just have got a small new utility (as can happen easily when you browse
a mailbox and found something that can become interesting in the future)
that consists of only one (archive) file or your friend gave you a disk
with 25 little tools and you forgot its contents after one week.
Now you would have to look for an empty disk, copy the file to it and
note on its label that beside some text files, a printer utility and two
pictures there is a new printer driver for WORD.
And imagine two months later you need just this program (or a friend comes
by and wants it from you) and have to search 200 Tools/Miscellaneous disks
for it.
┌────────────────────┐
│ STOP IT !!!! │
└────────────────────┴────┬─────────────────────┐
│ HERE COMES ARV !!! │
└─────────────────────┘
Arv organizes your file collection. Of course not your applications like
Pagemaker 4.0, Word for Windows or Turbo Pascal 6.0 since you probably
have your own disk boxes for them. No, ARV is for all the small utilities
and files that are hard to overlook.
ARV is very easy to use.
This is how ARV works:
──────────────────────
a) Files are organized in groups (eg. Graphics, Soundblaster,
Pascal sources etc.).
b) Files are stored on disks. Each disk belongs to exactly one group.
The files will be distributed among the disks by ARV itself. The user
merely needs to insert the disks ARV requests from him.
Files that are somehow connected can be linked together to handle them
as one.
Each disk gets a choosable identification and information where it
is stored (eg. upper board left, box 3 etc.).
c) To retrieve files from the archive the user only needs to select the
desired files in the list and press a key. ARV then prompts him for the
right disk and copies the file to a choosable directory.
d) Files can be added or deleted to the archive without problems. The space
from deleted files will be used by new files.
---------------------------------------------------------------------------
ARV -3- (c) Dirk Wriedt '91-'94
The advantages are at hand :
- no maintenance of the data is needed as in other database programs. The
data is managed by the same program that archives your files: ARV.
- the files can be retrieved quickly since ARV knows where they are
stored (presumed one is able to find his disks)
- the files will be simply copied to the disks with no further treatment
and sorted in groups. If one stops to use ARV there is nothing to do.
- if you get a new version of a packer etc. and you don't know where the
old one is stored or if the new one is really the newest version you
don't need to search your disk anymore. Just take a look in ARV's
catalogue.
Please print this document and read it! I know it could be better but
programmers are the worst documentation writers on earth and I rather
work on ARV than on its documentation...
If you face any problems: Contact me, preferably by email (see license
agreements for it).
---------------------------------------------------------------------------
ARV -4- (c) Dirk Wriedt '91-'94
┌─────────────────────────────────────────────────────────────────────────┐
│ 1.5. Installation of ARV │
└─────────────────────────────────────────────────────────────────────────┘
1) Create a directory on your harddisk in which you want to install ARV.
2) Copy all the files you got from uncompressing the ARV archive into
this directory. When in doubt, see section 8.3 for a list of the
needed files.
3) Change to this directory (CD) and enter INSTALL to start the
installation program. INSTALL is no real installation program but is
merly needed to set up the directory for temporary files which is
absolutely necessary. It will be referenced further as
TEMP directory. This is all that is needed to start ARV.
INSTALL prompts you for a path for the TEMP directory. Choose a
directory that
a) is on a harddisk partition with at least 5 MB of free
space. ARV doesn't really need 5 MB but merely about
1 MB. For temporary storing of files more space could
be needed though.
b) is only used by ARV (it gets completely deleted sometimes !)
INSTALL suggests <ARV directory>\TEMP. If the desired direcory doesn't
exist ARV can create it for you.
4) Print this documentation.
5) Read it !
6) Start ARV by changing to it's directory and type ARV.
---------------------------------------------------------------------------
ARV -5- (c) Dirk Wriedt '91-'94
┌─────────────────────────────────────────────────────────────────────────┐
│ 2.Description of ARVs list displays │
└─────────────────────────────────────────────────────────────────────────┘
The description of the key functions in a list display has been removed.
Most of the key functions are shown in the bottom menu of a list display
and they are also listed in the help page (press F1). You will find many
special functions there, too. You should see it since a lot of options are
explained there only. To have a good overview, you can of course print
the help pages, too.
It's helpful to have a printed copy of this text to understand the
following explanations.
2.1 The group list (the first list you see after the program starts)
────────────────────────────────────────────────────────────────────
As mentioned before the files are bundled in groups. Each group should
contain files that are similar in some way so it's easier to find files
you don't know the name of.
In the group list all groups are listed in alphabetical order. Each line
shows the short name, the complete name, the number of disks and the
overall size in bytes of this group.
The short name is used to identify the disks that belongs to a group. A
disk is usually named by the short name with a number appendend to it.
Example:
A group containing FAQs from Usenet can have the
name "Frequently asked questions from Usenet"
short name "FAQS"
disk name "FAQS 1", "FAQS 2", "FAQS 3" etc.
These short names are suggested from ARV when you assign a new disk
to it but you can change them if you want to. However, the above method has
some obvious advantages. The short names are intented to be the labels
of the disks. This is all one has to write on a disks label.
ARV recognizes his own disks by a file named DISK.ID that contains the
internal number of a disk.
This list is the only list one can see when no files are archived yet.
So, for a good start
a) read the next chapters carefully
or
b) read only the chapters 1.5 and 8. Then start ARV and
hit "+". By doing this you tell ARV that you want to
add new files to the archive. Don't worry, when you're
lost. You can get help everywhere (well, almost)
by pressing "F1".
To go through the group list you use the cursor keys, if there are any
groups, of course. By pressing <Enter> you enter the
---------------------------------------------------------------------------
ARV -6- (c) Dirk Wriedt '91-'94
2.2. Disk List for group "whateveritsname"
──────────────────────────────────────────
Here are all the disks displayed that belong the the selected group. This
is the identification (disk name), the free space, the drive letter the
group short name, the disk location and the creation date of the disk.
As mentioned in 2.1 before, the ID should be written on a disks label,
because when ARV wants you to insert a disk it prompts you with this name,
eg. "Please insert disk FAQS 7 into drive B". If you defined a location
text it is also shown. Those who own a lot of disks should attach such a
short description of a disks location, eg. "Box 4" or "Shelf top left".
If you press <Enter> in this list you come to list 2.3. :
2.3. File List for disk "whateveritsname"
────────────────────────────────────────
Here are all files displayed that reside on the specified disk.
Along with the file name, ARV stores & displays:
File size in bytes, the file date, disk id, the group the file belongs
to.
When a file is a "primary file" of files linked together, the symbol
"** H **" (H for "Hauptdatei", the appropriate german expression)
appears to the very right in that line.
When a file is linked to another file, but not the primary one of the
bunch of files, the first few characters of the name of the primary file
are displayed.
This is the default setting. As in all other file lists, you may use
<Tab> to switch to comments display and back at any time.
"Hmmm. Really nice, but what do you mean with 'primary file' or files
being linked together?"
O.k.: Every now and then, it happens that you add files to your ARV
archive that belong together somehow.
As you have found the file you need, you won't want to search for
the files belonging to this file.
To assist you here, you may LINK files together. This is done in
the way that one file is called the primary file, and the others
are being linked to it.
The important point here is that linked files can easily be
retrieved alltogether just by marking one of the files for
retrieval. Furthermore, you may decide to tell ARV not to list
non-primary files on screen. This will make your lists more tidy.
Use <Shift-Tab> to select wether non-primary files should be displayed
or not.
Of course, there are further lists to view, displaying the data by
different criteria.
---------------------------------------------------------------------------
ARV -7- (c) Dirk Wriedt '91-'94
2.4. List of files of group "whateveritsname"
─────────────────────────────────────────────
As the name tells us: This is a list of all files belonging to the current
group.
2.5. List of all disks
──────────────────────
This is a list of all your ARV disks. What else should it be?
Useful to have an overview over how much space is left on your disks.
2.6. Liste "all files"
──────────────────────
Guess what... All your archived files.
And this can be a *long* list. Same data as in 2.3.
2.7. List "add new files to ARV"
────────────────────────────────
This is no real ARV list, but a directory list. You mark files to be
included in the ARV archive using <Enter> or <Space> or <Grey Plus> and
then tell ARV to start the archiving process (by pressing <End>).
While marking files to be archived, they may already be linked.
All files and directories in the current (chosen) directory are displayed.
Linked files have the same small letters written behind them.
The function key assignments are displayed in the last screen line,
if set. See chapter 6 on how to use function keys.
Please use F1 in this list to learn about the numerous possibilities.
---------------------------------------------------------------------------
ARV -8- (c) Dirk Wriedt '91-'94
┌────────────────────────────────────────────────────────────────────────┐
│ 2.8. Flags (Attributes) │
└────────────────────────────────────────────────────────────────────────┘
Files and Disks may have flags or attributes assigned to them
They signal that the file or disk have special properties.
The disk flags are displayed in the disk lists, to the very right of
the disk description line.
The file flags are viewed by pressing <Enter> in a file list.
Ok, lets take a look at the flags.
┌────────────────┐
│ file flags │
└────────────────┘
As it stands, there is only one type of file flag, the "marked" flag.
A file is marked if it appears in the list of marked files.
ARV keeps track of marked files in two ways:
A file marked in inserted in the "marked files" list, and its
"marked" flag is set.
This is necessary because of the fact that
a) ARV has to show what files are marked in the lists; you want to
see what you have marked, don't you? It would be too slow to look
up each file in the "marked files" list as it it displayed; thus,
the flag is needed.
b) ARV has to know what files are marked when retrieving, deleting
or doing elsewhat with all marked files. It would take too long
to search the whole ARV data file for marked files; so we need the
"marked files" list.
You tell which files are marked by the ■ (i.e. a white block) right
behind the file name in the file lists.
┌──────────────┐
│ disk - flags │
└──────────────┘
"S" : This disk is locked and no more files will be put on it.
Use CTRL-F10 to Lock/Unlock a disk.
"K" : This flag is only used when describe_arv is set to "ja",
"yes" or "on."
It is set automatically when a comment to a file residing
on this disk is being changed.
The next time the disk happends to be accessed by ARV, the
comments are updated. Use CTRL-F10 to do this manually.
---------------------------------------------------------------------------
ARV -9- (c) Dirk Wriedt '91-'94
┌────────────────────────────────────────────────────────────────────────┐
│ 3. ARV and 4DOS │
└────────────────────────────────────────────────────────────────────────┘
ARV supports the 4DOS DESCRIBE command.
When a new file is added, ARV automatically detects the presence of a 4DOS
style descript.ion file in the same directory as the file and takes
over the appropriate file comment for the new file.
For those who do not know about descript.ion files: These are simple
description files to allow 4DOS's DIR command to display a file comment
along with the file name. A typical 4DOS description file looks like this:
4print.arj The 4print landscape printing program
simpsons.txt Simpsons Episode Guide
arv134.arj Latest ARV program version
i.e. each text line begins with the file name, followed by a space
and the description text.
If describe_arv is set, the ARV comment will be written to the
ARV disk in 4DOS description style. That means that the 4DOS "dir"
command will list the files on ARV disks along with their descriptions.
Should your ARV data files (*.AR? - files) get corrupted and you have
to rebuild them using the CTRL-F10 "add whole disk" function, the
file comments won't be lost: ARV can read them from the descript.ion
files. So please leave describe_arv on.
if describe_geholt is set, retrieved ARV files will be equipped
with a 4DOS style comment. This has many advantages: The files you
have retrieved to your hard disk will have 4DOS comments. If someone
of your friends takes the files with him, he will have the comments
along with the files and does not have to invent them again...
---------------------------------------------------------------------------
ARV -10- (c) Dirk Wriedt '91-'94
┌─────────────────────────────────────────────────────────────────────────┐
│ 4. The "swapping files" function (registered version only) │
└─────────────────────────────────────────────────────────────────────────┘
ARV supports swapping of files. If you and your friends all use ARV,
and regulary look at each other's files, ARV assists you in looking for
files your neighbor has and you don't.
Provided you have not set the option gesehen_liste to "no", ARV
maintains a list called XXXXXXXX.ALL, where XXXXXXXX is your registration
serial number. This serial number is important to distinguish different
.ALL-files.
The file XXXXXXXX.ALL stores name, size and date information of all files
you have ever "met". These are all files you have ever added to your
ARV data files (even if they are deleted by now), or files you have
seen using the "swapping files" function and decided not to add.
And that's how it works:
Somebody "A" with ARV registration number XXXXYYYY walks over to his
friend "B" with ARV reg. number UUUUVVVV.
He takes some empty disks with him, along with his file XXXXYYYY.ALL.
"A" copies XXXXYYYY.ALL to his friends "B"'s ARV directory. "B" runs ARV,
switches over to any file list, and presses CTRL-F8.
(*) He chooses the "swapping files" function from the appearing menu.
ARV searches its data directory for any .ALL files and finds XXXXYYYY.ALL.
Now "B"'s ARV marks all files that do not appear in "A"'s list. Don't
worry, this is very fast. As a result, all files are marked that
"A" has never seen before.
Now "A" switches over to the "list of marked files" using "H" and browses
through the marked files, deleting files from the list he doesn't want.
"A" can now retrieve the files from "B"'s ARV in the usual way, i.e. by
pressing CTRL-H.
Note: The old mark list in _not_ erased before the marking process,
i.e. the files are marked additionally to these marked before.
Please also consult the option dateien_vergleich in chapter 6.
"B" then moves these files to the disks he has brought with him.
If more files are new than could me marked (there is a limit on
the maximum number of marked files, see 5.8.), ARV tells you so
and you will have to repeat the process from (*).
After all files have been retrieved, ARV has already deleted XXXXYYY.ALL
and created a new files VVVVYYYY.DIF. This is a file containing
information about all files "A" has met in this session, that means,
of course, all files "B"'s ARV has states as being new. Thes files "A"
did not want to take with him are in this list, too.
"A" goes home and copies "VVVVYYYY.DIF" to his ARV data directory.
The next time "A" runs ARV, ARV finds the .DIF file and adds all the
files in it to XXXXYYYY.ALL. Afterwards, the .DIF file is being deleted.
"A" will now add the files he got from "B" in the usual way.
---------------------------------------------------------------------------
ARV -11- (c) Dirk Wriedt '91-'94
"Now, what the heck?"
The next time, "A" takes his .ALL file to friend "B" or "C", the
friend's ARV will be able to determine which files "A" has already seen
and which files are new.
Note:
─────
"A" is not obliged to take the VVVVYYY.DIF file with him. In this
case, when he uses "swapping files" with "B" the next time, he
will be presented all files he did not take with him again. That is
clear, as theses files have not been added to "A"'s .ALL file.
The files "A" took with him are of courses anyway in his .ALL file.
---------------------------------------------------------------------------
ARV -12- (c) Dirk Wriedt '91-'94
┌─────────────────────────────────────────────────────────────────────────┐
│ 5. Notes │
└─────────────────────────────────────────────────────────────────────────┘
5.1. Printing of this documentation file
────────────────────────────────────────
Using PRINT arv.dok or COPY arv.dok prn
5.2. Speed
──────────
ARV should be run with a hard disk cache installed.
All list display will be noticably slower without a cache installed,
as ARV keeps very few data entries in memory. All data is fetched from
the hard drive as soon as it is needed. This way, ARV will maintain up
to 2147483647 groups/disks/files.
To speed data access, ARV has a built-in record level cache.
If EMS is available, the overlay management will be faster.
5.3. virus protection
─────────────────────
ARV.EXE has a built-in virus protection. Every time ARV is run,
the first 64 and the last 64 bytes are checked. If the checksum check
fails, ARV will issue a warning and refuse to run. You will have to
replace ARV.EXE and ARV.OVR from the original archive file.
Please do not use .EXE-compressing tools like LZEXE or PKLITE
to compresse the ARV executables. This will confuse the virus check.
You should not use CRC-checking tools that append a checksum to the
end of the executables, either. The documentation to ViruScan by
McAffee associates mentiones this.
5.4. Special functions/should anything go wrong
───────────────────────────────────────────────
Should any of your ARV files get corrupt or lost, simply delete it using
the standard "DeL)ete" function from the ARV catalog, inserting the ARV
disk as requested. ARV does not check the file's existance when deleting.
In earlier version, rumor had it that ARV could hang itself up when a list
is selected, especially if there was no data to display. In this case,
use CTRL-ALT-DEL to reboot your computer. No ARV data will be lost, just
check that your write-behind-cache (if installed) has written its data.
In the disk lists
─────────────────
The special functions are called via CTRL-F10. The special functions
menu appears.
These functions are available:
disk check.
Compare the ARV data against actual disk data. ARV checks if there
---------------------------------------------------------------------------
ARV -13- (c) Dirk Wriedt '91-'94
are exactly the files on the disk that ARV has stored in his data files.
If any files are missing either on the disk or in the ARV catalogue,
this will be corrected.
lock/unlock disk
Toggle "locked" state of disk. This disk will will be no more looked at
when selecting a disk for a new file.
rewrite comments
As the name suggests, the comments of the files on this ARV disk are
rewritten. Note that the comments are only written to disk if
describe_arv is set. If this option is unset, ARV will erase the
descript.ion file on this disk.
Normally, this function should not be needed, as ARV automatically keeps
track on which komments have been changed and have to be rewritten.
remove disk
The disk selected will be removed from the ARV data files. No files
will be physically deleted, nor the disk will be requested.
Use this function if a disk has gone lost.
reread free disk space
Re-read free space on disk. Apart from that, ARV re-reads the cluster
size, i.e. the smallest unit that can be allocated.
Use this function after moving the contents of an ARV disk to another
disk, e.g. from 5.25" to 3.5". ARV then needs to know about the changed
figures.
write DISK.ID
You may let ARV write the id of the selected disk anywhere you like.
Use this function if the DISK.ID file of any ARV disk has been corrupted.
In the groups list
──────────────────
CTRL-F10 will add a whole disk to the ARV catalog system. This disk
will belong to the currently selected group.
Use this function
a) if you have a disk full of files which all fit into one ARV group.
b) to re-read ARV data after system crash, if your *.ARV files have
gone lost or got so corrupted ARV_SOS can not repair them.
In the file lists
─────────────────
CTRL-F10 and CTRL-F8 call up the special file functions menus.
CTRL-F10 gives you access to functions dealing with one file,
CTRL-F8 deals with more general operations.
Amongst them are:
remove "marked" flag from all files
───────────────────────────────────
ARV is keeping track of marked files in to ways:
All files marked are kept in a list. This is necessary to allow fast
access on all marked files.
All files marked carry a special "marked" flag. This way, ARV can
show you the files marked in the file lists (■) without searching the
---------------------------------------------------------------------------
ARV -14- (c) Dirk Wriedt '91-'94
"list of marked files" for each file.
When you quit ARV, all of the "marked" flags will be removed.
When ARV is terminated abnormally, e.g. when a "runtime error" occurs,
the "marked" flags will not be removed. This way, files may have the
"marked" state without actually being marked.
This function will clear alle "marked" flags.
MarkByMail - function
─────────────────────
ARV will request the name of a text file.
This file will be treated as a list of file names, i.e. all file names
have to start at the same column. All files in this list will be marked.
Imagine you have set ARV to automatically send a list of new files to
all your friens via electronic mail each time you add new files to the
ARV system. Your friend edits the list and saves it to disk. He walks over
to you with the disk, activates MarkByMail and schwupp-di-wupp (as we
germans say for "in no time") he has the files marked in your ARV system
and retrieved to his disk.
"swapping files" function
─────────────────────────
There is a whole chapter dedicated to this function. Please consult
chapter four.
5.5.
────
<obsolete>
5.6.
────
In earlier version, rumor had it that ARV could hang itself up when a list
is selected, especially if there was no data to display. In this case,
use CTRL-ALT-DEL to reboot your computer. No ARV data will be lost, just
check that your write-behind-cache (if installed) has written its data.
5.7.
────
It is not possible (yet?) to copy files to multiple disks as they are
retrieved.
You have to retrieve the files to your hard disk and copy them to disk
afterwards.
5.8.
────
maximum number of marked files
The maximum number of marked files ist 1000.
---------------------------------------------------------------------------
ARV -15- (c) Dirk Wriedt '91-'94
5.9.
────
Important note: ARV does not check the maximum number of files in the
ARV disks' root directories. As you know, the root directory of each
disk can only hold files up to a disk-size specific maximum (e.g.
112 on a 3.5" 720k disk). ARV will crash with a runtime error if this
number is exceeded. If this has happened, use the "disk special functions"
to lock this disk.
5.10.
─────
If you are using ARV non-registered, you can not use other people's
ARV *.ARV data files (e.g. by copying them over your data files).
If you are a registered ARV user, you _can_ use other people's ARV *.ARV
data files (whatever the reason may be). You should _not_ use, however,
the data files of non-registered users as they will no more be able to
access the files. This restriction does not apply if you are installing
other people's data files as another than the primary partition (e.g.
by using "copy \mikes_arv\*.arv \my_arv\*.ar2" to install mikes ARV data
files as your 2nd partition).
5.11.
─────
On being run, ARV creates a file named ARVAKTIV.SEM in the ARV data
directory (see chapter 7.). This file is deleted when you leave ARV.
ARV will refuse to run if it detects this file. This is to prevent
you from running ARV twice (from a shell, for example) or running
ARV tools (ARV_SOS or ARV_OPTI) while ARV is still accesssing the data
files.
Note that ARVAKTIV.SEM is not created in the executables directory (see
chapter 7) so that you have another copy of ARV running at the same
time as long as it accesses a different set of data files.
ARV_SOS, ARV_OPTI, RESETARV and ARVEXPO also check for and create
ARVAKTIV.SEM.
ARVAKTIV.SEM consists of a single line of text:
XXX description
XXX is a three-digit number which identifies the program that is
currently accessing the data files. "description" gives you the same
information in textual form.
Should ARV terminate abnormally, e.g. due to a run time error or a hard
or soft reset, ARVAKTIV.SEM will not be deleted. Consequently, ARV will
refuse to run next time you try to. In this case, you will have to delete
ARVARKTIV.SEM manually.
löschen.
---------------------------------------------------------------------------
ARV -16- (c) Dirk Wriedt '91-'94
┌─────────────────────────────────────────────────────────────────────────┐
│ 6. The ARV configuration files │
└─────────────────────────────────────────────────────────────────────────┘
6.1. ARV.CFG
────────────
ARV.CFG is the ARV's main configuration file.
It may look like this:
[ARV]
tempdir=c:\temp
zeigeverbund=no
selbegruppe=off
linkerrand=5
wartevorseite=on
i.e. each line begins with an option identifier (which is always german,
or a mixture between english and german, the germans like using english
expressions because the german expressions are a bit longish sometimes).
The option identifier is followed by an equal sign or a space, followed
by the value to set the option to. Lines beginning with * are ; are
ignored, use these to include comments in you config file. Empty lines are
allowed but ignored.
Please read chapter 7 on where to put your ARV.CFG file.
Ooops, [ARV] does not quite fit in this pattern. Why that?
ARV.CFG is no longer used exclusively by ARV, but by ARV tools, too.
For exmaple, the ARVDIR configuration can also be done in ARV.CFG.
The configuration section for ARV has to be started with [ARV].
The ARV config section ends
a) at the end of the file ARV.CFG
b) at any line of the form [XXX], where XXX is the identifier
of the program whose configuration data follows.
Only one section [ARV] is allowed.
If you have not used or are not going to use the INSTALL program:
You _have to_ set the option tempdir.
tempdir has to point to an empty directory on your _hard disk_. The
hard disk hosting this directory should have enough space to buffer
files you are going to retrieve from your ARV system. 5 MB are advisable.
Please specify the full path name for tempdir, for example:
tempdir c:\arv_tmp
This is the only option you are obliged to set.
---------------------------------------------------------------------------
ARV -17- (c) Dirk Wriedt '91-'94
Other options are (you really should print this file!):
afx_verz=path name
If you specify a path here, ARV will search all .AFX-files in this
directory to get file comments.
Example:
afx_verz=c:\lists\afx
will make ARV search the c:\lists\afx directory for .afx-files and
search theses files for comments.
Only if the search in all these files fails, ARV will search the files
given by "files_bbs" options.
File commments are searched for for files to be added that don't have a
comment, or by pressing K or CTRL-K in the "file addition" file requester.
Thus, one afx_verz directive will save you from multiple files_bbs
directives.
To learn about .afx files, please consult compfls.dok.
.afx files are file lists compiled using COMPFLS.EXE that can be
searched much faster that plain text files.
───────────────────────────────────────────────────────────────────────────
alternative_liste=on/off
ARV normally displays file name, file size, file date, ARV disk id and
the file's group in all file lists.
Alternatively, you may have displayed the file name and its comment.
The display mode can be changed by <Tab>.
To set the default mode, use the option "alternative_liste":
alternative_liste on
selects file comments
alternative_liste off
selects normal display mode.
The default setting is "off".
──────────────────────────────────────────────────────────────────────────
altf1=... up to altf10=...
Adding new files to the ARV archival system is often not as
straightforward as one expects. Many of the files in your "misc. files"
directory have been there for long, and you do not remember what they
where for or what type of program is hidden in HEYABC.ARJ.
---------------------------------------------------------------------------
ARV -18- (c) Dirk Wriedt '91-'94
Of course, you have tools to view archives and pictures, but it would be
tedious to do all the sorting out of files by hand.
To aid you, the function keys alt-f1 to alt-f10 may be assigned DOS
commands to be executed to do anything with the currently marked file.
The syntax is
altf1=__Command1;comment1
..
altf10=__Command10;comment10
The first two characters after the equal sign do not belong to the
command to be executed, but enable special treatment:
For the first character:
_ nothing special
M Multi: This command will be called for each marked file.
T wait for keypress after execution
W Both M and T options.
For the second character:
_ nothing special
L the directory will be re-read after execution
(use this for commands that delete or create files!)
In the command text, % will be substituted by the name of the selected
file, $ by the name of the file chosen with "N".
Examples:
altf5=_Ldel %
deletes the file, then re-rereads directory.
altf2=T_aview %
Shows the contens of any archive by calling "aview".
altf7=M_lha a $ %
adds all marked files to the archive which name was chosen using
"N".
Note:
You should make the archive file name always point to a file name on your
hard disk, e.g. by specifying
altf7=M_lha a c:\tmp\$ %
otherwise the archive file will be created in the current directory.
You can assign comments to your function keys: anything after a ";" in
the key assignment will be ignored for the command as be used as a
comment for the key. This comment will be displayed in the last screen
line.
See neu_info_modus on how the comments are displayed.
---------------------------------------------------------------------------
ARV -19- (c) Dirk Wriedt '91-'94
──────────────────────────────────────────────────────────────────────────
auswurf=on/off
If set to on, a form feed will be sent after a print job is completed.
──────────────────────────────────────────────────────────────────────────
belegung_bequem=on/off
ARV automatically selects an appropriate disk for files to be added to
the ARV system.
The disk is selected by the algorithm chosen by the \strategie~ option.
However, it may occur that, as a file is to be added, by chance a disk
just has been inserted which belongs to the same group as the new file
and has enough free space to carry the file.
The selected algorithm may choose a different disk for the file, which
would require an extra disk change.
To avoid that, thus saving time, you may state that ARV should put the
file on the disk already in the drive. This may not coincide with
the "strategie" algorithm selection, but what the heck?
belegung_bequem on
selects "lazy" behaviour
belegung_bequem off
selects "proper" disk selection
The default setting os "off" (for maximum disk usage).
──────────────────────────────────────────────────────────────────────────
cond_zeichen=0..255
Using cond_zeichen, you tell ARV how many characters fit in one line when
using condensed print (see condcode) on your printer.
The default setting is 135.
──────────────────────────────────────────────────────────────────────────
condcode=control sequence
Same as for picacode, but to select condensed print (17 cpi)
on your printer.
Default setting is condcode=15
Set the line length for this print mode using cond_zeichen.
See druckinit on what the sequence should look like.
──────────────────────────────────────────────────────────────────────────
---------------------------------------------------------------------------
ARV -20- (c) Dirk Wriedt '91-'94
datei_vergleich=0/1/2/3
When using the "swapping of files" fuction, ARV compares "your" and
"the other one's" files to determine the files new to you.
datei_vergleich specifies when two files are considered to be the same.
0 tells ARV to ignore file size and file date. Two files
are considered to be the same if they have the same
name.
1 tells ARV to take the file sizes into account, i.e.
two files will have to be of the same size and of the
same name to be considered as being identical.
2 tells ARV to take the file dates into account.
3 tells ARV to take both file size and file name into account.
The default setting is 3, not allowing you to miss any file.
──────────────────────────────────────────────────────────────────────────
describe_arv=on/off
This option controls wether ARV files will be equipped with comments in
a 4dos style descript.ion file on the ARV disks.
Please leave this option "on".
Should your *.AR? files should get corrupted, your file comments will be
lost if you have not enabled it. With "describe_arv on", you can simply
re-read all your disks' contents using the "add whole disk" special
function.
The only (minor) drawback: Less space will be on the disks for ARV files,
as the comments will be stored on them, too. However, usually, they use
up just a few hundred bytes.
If this option used to be on, and you switch it off, the existing
descript.ion comments files will be removed from the ARV disks in the
future.
You do not have to worry that the comments on the ARV disks could be
different from the comments kept resident by ARV:
As soon as a file comment is being changed, the disk will be marked with
the "K" flag to signal that the file comments need refreshing. The
desription file will be re-written as soon as possible (e.g. the disk is
inserted into the drive because files are to be retrieved).
──────────────────────────────────────────────────────────────────────────
describe_geholt=on/off
This option controls whether retrieved files will be equipped with
comments in a 4dos style descript.ion file.
on : as files retrieved have a 4dos style comment (i.e.
in the same directory, a file named "descript.ion" will
be created that holds a short description of the file)
off : the above will not be done
---------------------------------------------------------------------------
ARV -21- (c) Dirk Wriedt '91-'94
When you are using 4DOS, you should of course set (leave) this option
"on".
However, it is a very interesting thing for non-4dos-users, too:
When retrieving files for someone to take them with him who also uses
ARV, the comments will be read by the other ARV system.
The comments will, of course, be lost when the file is being copied by
the standard dos (not 4dos) "copy" command.
The default setting is "on". Please also refer to "lange_arv_kommentare".
──────────────────────────────────────────────────────────────────────────
directvideo=on/off
For Turbo/Borland Pascal Users, this option corresponds to the DirectVideo
Variable.
on : Text will be written directly to the screen memory. Fast.
off : The BIOS will be used to display text. Safe.
default is on.
──────────────────────────────────────────────────────────────────────────
dkf=Laufwerksliste
Please give the letters of all your 3.5" drive, so that ARV can display
the correct pictures with disk requests.
For example,
dkf=AB
if both your A and B drives are 3.5".
dkf=""
if you do not have any 3.5" drives.
The default setting is dkf=b.
──────────────────────────────────────────────────────────────────────────
doppelt_version=on/off
Enable/disable file version checking.
When a new file is going to be added, ARV checks if this file already
exists in the ARV catalog.
You may also let ARV check if there is already another version of the
file. This is controlled by this option.
ARV compares the file names to decide if the files are to be considered
the same or not.
Files are compared this way:
ARV searches for a numerical digit from the fourth position on. If any
---------------------------------------------------------------------------
ARV -22- (c) Dirk Wriedt '91-'94
are found, and less than two characters are following, the file name
is cutted off at the position of the digit.
Both file names will be treated this way. The files will be considered
to be the same if the remaining strings are the same.
Some examples:
"ARV1_23" == "ARV1_24"
"4PRINT2" == "4PRINT3"
"4PRINT2" <> "5PRINT2"
When this option is turned on, and a new to be added file's name matches
any other of the existing files' names, it will be presented to you in
the same way as if exactly this file was found in the ARV data files.
If "doppelt_version" is turned off, ARV will only warn you if the file
name you are going to add exactly matches the name of a file already in
the ARV catalog.
──────────────────────────────────────────────────────────────────────────
druckertest=on/off
"druckertest" selects wether ARV will check if the printer is ready
before printing.
This only works with parallel printers. If you are using
- a printer connected to one of your serial ports
- a network printer
you should set it to "off".
──────────────────────────────────────────────────────────────────────────
druckerport=1/2
If you have set "druckertest" to "on", you have to set the parallel port
you are printing to with this option. E.g. use druckerport=2 to tell ARV
the printer is connected to LPT2:.
To achieve high compatibility, ARV does not print directly to this port,
but to the PRN device. Thus, this option is only required to provide ARV
with the information necessary to be able to check if the printer is ready.
The default setting is "druckerport=1".
──────────────────────────────────────────────────────────────────────────
druckinit=control sequence
druckinit defines a sequence of characters to be sent to the printer
before printing. All characters have to be given by the respective ASCII
code.
Example:
druckinit=27 64
---------------------------------------------------------------------------
ARV -23- (c) Dirk Wriedt '91-'94
will send <Esc>@ before each print.
By default, druckinit is empty.
──────────────────────────────────────────────────────────────────────────
fbbs_descol=...
See files_bbs=...
The default setting is 19.
──────────────────────────────────────────────────────────────────────────
festplatten=list
By default, ARV treats all drives but A: and B: as floppy, that is,
removable, drives. If that is not the case in with your system,
please specify all hard disk letters here. You may have used SUBST
to make A or B being a directory on your hard drive or you may be
working in a network environment with H pointing to some floppy drive.
festplatten=CDEGHI
would tell ARV only drives C:, D:, E:, G: and H: are not removable.
In doubt, you should rather consider a drive removable than non-removable.
The correct setting of this option is more important as you might expect
at first, but ARV needs this info to decide if a file to be copied has
to be buffered on the hard disk and things alike.
──────────────────────────────────────────────────────────────────────────
files_bbs=<file>
The name of this option is derived from the name of a description file
used by bulletin board systems (BBSs) to describe the contents of
files provided for download.
files_bbs defines the name & path of a FILES.BBS-type file to be
searched for a file comment if no descript.ion comments is found.
The file extension is be ignored. The search can be aborted by <Esc>.
Example:
files_bbs=g:\fd\files.bbs
ARV expects the file name to start at the first column and the
description to start at the column specified by files_bbs. You can
specify up to 20 files_bbs files. The current fbbs_descol value is
memorized for each files_bbs file, so you can have different description
columns for each file.
Example:
.
.
files_bbs=c:\fd\02420257.lst
fbbs_descol=20
files_bbs=c:\fd\fredfile.lst
---------------------------------------------------------------------------
ARV -24- (c) Dirk Wriedt '91-'94
fbbs_descol=17
files_bbs=c:\fd\miscfile.lst
.
.
will define three file lists, with ARV looking for the description
at the 19th column in 02420257.lst, at the 20th column in fredfile.lst
and in the 17th column in miscfile.lst.
You will soon discover that the lookup in text files is very slow.
If you have long file lists to search, you should compile them using
CompFLS. CompFLS will transform any file list to a compiles list
with a .AFX extension. Please see compfls.dok on how to do that. The
search in .AFX file lists is incredibly fast, compared to standard text
search.
ARV ist intelligent: If the file you have specifies does not exist,
ARV will look for a file with the same name but extension .AFX. Even if
the file exists, but a corresponding .AFX list exists, too, ARV will
look the file name up in the .AFX file list, as this is faster.
For clarification:
concerning files_bbs=g:\fd\file\02400060.lst
If file ... exists then
g:\fd\file\02400060.lst g:\fd\file\02400060.afx
no no error (but
see below)
yes no standard
text mode
search
no yes fast .AFX
search
yes yes fast .AFX
search
┌───────────────────────────┐
Now, │ what is a FILES.BBS file? │
└───────────────────────────┘
A FILES.BBS style file is a standard text file looking like this:
SUPER1.LZH This is really great
XYZ.TXT The new xyz tool
BALLER.ARJ Shoot'em up by Abc inc.
Each line begins with a file name, and ends with a description for the
file. The starting position of the description may vary.
Note:
If the first character of the file name is a "!", ARV will not report
an error message if the file does not exist, but will simply skip that
files_bbs entry.
The "!" will be cut off from the file name.
This is a special feature if you want to use files.bbs files that
reside in the same directory as the files to be added. You would then
add an option like
files_bbs=°.\files.bbs
---------------------------------------------------------------------------
ARV -25- (c) Dirk Wriedt '91-'94
to your ARV.CFG.
──────────────────────────────────────────────────────────────────────────
gesehen_liste=on/off
Only "off" will make sense here (default setting is gesehen_liste=on),
and only for registered users.
If you set gesehen_liste=off, ARV will not maintain the XXXXXXXX.ALL file
you need to use the "swapping files" function for yourself.
This will save you some, but not much, disk space.
.ALL files of others will be treated in the normal way if gesehen_liste
is off.
──────────────────────────────────────────────────────────────────────────
kommentaresofortschreiben=on/off
Up to version number 1.29, ARV has rewritten the file comments for any
ARV disk as soon as a new file has been written to it.
From 1.29 on, ARV waits until the next disk change. This will save you
time because of no more unnecessary ARV disk descript.ion updates. So
kommentaresofortschreiben is set to off.
If you want to revert to the old behaviour for maximum safety,
set kommentaresofortschreiben on. If you have set describe_arv to
"off", this option is irrelevant to you (but think it over again!).
──────────────────────────────────────────────────────────────────────────
kommentarnachfrage=on/off
By default, ARV will ask you for confirmation when it has found a file
comment by searching any file list.
You may choose that you will always accept the first comment ARV finds,
and set
kommentarnachfrage off
There is an exception, however, if you have specified a directory to
search for .AFX-files (see option afx_verz). ARV will always scan for
comments in all of the .AFX-files in this directory before presenting a
list of all comments found. The AFX file search method is fast enough to
permit this behaviour.
──────────────────────────────────────────────────────────────────────────
lange_arv_kommentare=on/off
on : Full length comments (79 chars) will be written to
4dos-style-descript.ions on ARV disks.
4DOS below version no. 4.0 will be confused by this.
off : The comments written to the descript.ion files
---------------------------------------------------------------------------
ARV -26- (c) Dirk Wriedt '91-'94
on the ARV disks will be truncated to 40 chars.
This option is ignored if describe_arv is set to off.
The default setting is on.
──────────────────────────────────────────────────────────────────────────
lange_hol_kommentare=on/off
The same as for lange_arv_kommentare, but for 4DOS-style descript.ions
written during file retrieval. This option is ignored if desribe_geholt
is set to off.
──────────────────────────────────────────────────────────────────────────
lindex_divisor=SomeValue
The performance index displayed by the "Statistics" page will be divided
by whatever you specify here. Thus, to set the performance index to 1,
read its value, then put it here. The default setting, who would have
guessed, is 1.
──────────────────────────────────────────────────────────────────────────
linkerrand=0..255
When printing, ARV will leave this number of characters blank on each line
as a left margin.
──────────────────────────────────────────────────────────────────────────
markbymail=<file name>
Anything you specify here will be the default file name preset when
invoking the MarkByMail function.
──────────────────────────────────────────────────────────────────────────
maxzeilen=yes/no/auto
maxzeilen defines which video mode ARV should run in.
yes : use 43(EGA)/50(VGA) line mode. Switch back to 80x25
on exit.
no : use 80x25 mode.
auto : Do not change video mode. ARV will use the currently
active video mode.
If you are not using a VGA/EGA adapter, you should select "no".
──────────────────────────────────────────────────────────────────────────
nach_aufnahme=<dos command>
You want to keep a list of files you have added recently?
You want to send a list of new files to your friends by email each time
you add new files to ARV?
nach_aufnahme specifies a DOS command to be executed after any files have
---------------------------------------------------------------------------
ARV -27- (c) Dirk Wriedt '91-'94
been added to the ARV catalog. Please give the complete path to the
command, too (unless, of course, the command is DOS internal, e.g. COPY).
Prior to executing the nach_aufnahme command, ARV will write the file
"AUFNAHME.TXT" to the ARV data directory. AUFNAHME.TXT is a text file
containing information about added files, one on each line.
By default, the file's name, length, date and comment are listed. The file
format can be chosen freely via the "AUFNAHME.CFG" config file. See chapter
6.2.
As an example, I have enclosed NACHRICH.BAT, which demonstrates how
nach_aufnahme can be used to mail a list of new files to your friends.
This command will keep a list of all files added in c:\arv\new_files.txt:
type aufnahme.txt >>c:\arv\new_files.txt
──────────────────────────────────────────────────────────────────────────
neu_datei_vergleich=0..3
This option works just like "datei_vergleich", bu it refers to how are
files being compared when using the "mark all files already in ARV" and
"unmark all files already in ARV" in the "Add new files" file requester.
0 tells ARV to ignore file size and file date. Two files
are considered to be the same if they have the same
name.
1 tells ARV to take the file sizes into account, i.e.
two files will have to be of the same size and of the
same name to be considered as being identical.
2 tells ARV to take the file dates into account.
3 tells ARV to take both file size and file name into account.
The default setting is 3, not allowing you to miss any file.
──────────────────────────────────────────────────────────────────────────
neu_info_modus=-1..2
neu_info_modus defines what is to be displayed in the last screen line in
the "adding new files" file requester.
neu_info_modus can take one of the following values:
-1 - automatic: Display file comment, but switch to
appropriate display when shift or alt
is held down.
0 - Display Altf1..Altf10 dos command function
key comments
1 - Display Shiftf1..Shiftf10 path function
key comments
2 - Always display file comment
The default value is -1, and there should be no reason to change it.
──────────────────────────────────────────────────────────────────────────
---------------------------------------------------------------------------
ARV -28- (c) Dirk Wriedt '91-'94
pica_zeichen=0..255
Using pica_zeichen, you tell ARV how many characters fit in one line when
using standard pica print (see picacode) on your printer.
The default setting is 79.
──────────────────────────────────────────────────────────────────────────
picacode=sequence
picacode defines the sequence of characters to be sent to the printer
to select (standard) pica pitch, i.e. 10 cpi.
The default setting is picacode=18
See option druckinit on how the sequence should look like, and
pica_zeichen on how the line length for pica can be changed.
──────────────────────────────────────────────────────────────────────────
ppp_aufdisk=on/off
If you have selected file comment display using "alternative_liste"
(please see there), you can choose what to do with files without a
comment:
select
"ppp_aufdisk on"
to make ARV display the id of the disk the file is archived on.
"ppp_aufdisk off"
to leave the comment space blank.
──────────────────────────────────────────────────────────────────────────
randoben=0..255
When printing, ARV will leave this number of lines empty at the top of
each page, as a top margin.
Default is no, none, zero, nothing.
──────────────────────────────────────────────────────────────────────────
s_swapping=on/off
s_swapping controls if ARV will try to swap itself out of precious low
memory (lower 640k) when you are "shelling to DOS". Remember: The DOS
shell is invoked by pressing CTRL-S or F9.
on: ARV will try to swap. It will swap to EMS, if available, or
to a file named "ARVxxxxx.$$$" in the ARV.EXE directory.
xxxxx will be 5 digits 0-9. This file has the "hidden"
attribute set, so you won't see it using dir, but
using attrib.
This way, ARV will occupy only about 5000 bytes.
---------------------------------------------------------------------------
ARV -29- (c) Dirk Wriedt '91-'94
off: ARV will not try to swap. On systems with slow disk access, this
will save you time if you don't have EMS.
The former is the default setting.
──────────────────────────────────────────────────────────────────────────
seitenlaenge=0..255
seitenlaenge specifies the number of lines that fit on one page when
printing. This should include the top margin set by randoben.
The default is 65.
──────────────────────────────────────────────────────────────────────────
selbegruppe=on/off
If you already link files to be added in the file requester (where you
select the files to be added), you usually would like to have the
linked files to belong to the same group as the primary file.
Give "selbegruppe on" to make ARV always put the linked file into the
same group as the primary file.
──────────────────────────────────────────────────────────────────────────
shiftf1=... to shiftf10=...
Most people will have some directories they collect new files until
they are to be arved, that means, added to the ARV catalogue system
and written to ARV disks.
To save you lots of keypresses, you may use thie shifted function keys
as "path macros", assigning a path to each that can be easily recalled
just by pressing the appropriate shift-function key.
The syntax is:
shiftf1=path;comment
e.g.
shiftf1=c:\dfue\down;download
will assign the c:\dfue\down path to shift-f1, with the comment
"download".
The comment will be displayed in the bottom screen line.
See neu_info_modus for further details.
──────────────────────────────────────────────────────────────────────────
standardverz=path
This sets the default directory for adding files. When you select
"add new files" for the first time, ARV will display this directory.
──────────────────────────────────────────────────────────────────────────
---------------------------------------------------------------------------
ARV -30- (c) Dirk Wriedt '91-'94
strategie=0..2
Using strategie, you select the algorithm ARV uses to select the
appropriate disk for a new file to be added to the ARV system.
Possible choices are:
0 : "Best fit" - the file will be assigned to the disk
which will have the least space remaining after the file
has been copied to it.
This strategy will result in the most "disk jockey" work,
requiring the most disk changes.
ARV disks will be used in a most effective way,
leaving as least space as possible.
This is the default algorithm.
1 : "First fit" - The file will be assigned to the FIRST
disk that has enough free space on it.
This means, disks will be filled in the order
"Tools 1", "Tools 2", "Tools 3" etc.
This effectively results in disks with lower serial
numbers being filled as soon as possible.
2 : "Last fit" - The file will be assigned to the LAST
disk that has enough free space on it.
This means, disk will be filled in the order
"Tools 7", "Tools 6", "Tools 5" etc.
Using this method, newer files will be found on disks
with higher serial numbers.
NOTE: No new disk will ever be created if there is enough space on one
of the disks belonging to the file's group.
──────────────────────────────────────────────────────────────────────────
swapping=on/off
This option decides wether ARV will swap itself out of memory when a
DOS command is executed. This may be the "nach_aufnahme" DOS command,
or a command activated by pressing "Alt-.." in the "add new files" file
requester.
Please consult the description of "s_swapping" on how to use "swapping".
The default setting is "on".
──────────────────────────────────────────────────────────────────────────
toddlkomm=on/off
The name of this option might sound a bit strange, it originates from
the name of the beta-tester who by any means needed this function.
on/yes : When asking for text entry, always use last input as
default.
off/no : Don't do it.
The default setting is "off".
──────────────────────────────────────────────────────────────────────────
---------------------------------------------------------------------------
ARV -31- (c) Dirk Wriedt '91-'94
turbo_files=on/off
When entries in the GROUPS.ARV, DISKS.ARV & FILES.ARV data files are
being deleted, the are kept free until a new group, disk or file
(respectively) are created. ARV then searches for the next free
entry and uses it to store new data.
When adding files, this may be lengthy, because ARV will have got to
search the whole FILES.ARV for free entries.
Of course, this approach serves space by re-using the entries freed once.
You may speed up the addition of files by setting "turbo_files on".
With "turbo_files" enabled, ARV will not look for unused entries, but
append the new entry to the end of FILES.ARV.
This works much faster, but the FILES.ARV size increases much faster,
because of the "holes" not being filled.
Use ARV_OPTI to optimize FILES.ARV from time to time.
The default setting is "turbo_files no".
──────────────────────────────────────────────────────────────────────────
wartenachseite=on/off
on : before each form feed, ARV will wait for a keypress.
off: this will not happen.
──────────────────────────────────────────────────────────────────────────
wartevorseite=on/off
on: after each form feed, ARV will wait for a keypress. Use this to
print on single sheets with manual feed.
off: as you might expect.
──────────────────────────────────────────────────────────────────────────
zeigedatei=command
Put in name & path of your favourite file lister here, e.g.
zeigedatei=c:\tools\list.com %
If set, ARV will not use its own lister when Z is pressed in the "add
new files" file requester, but execute this command. "%" is substituted
by the file name.
You really should set this one, the built-in lister s++++.
──────────────────────────────────────────────────────────────────────────
zeigeverbund=on/off
As you know, you may link files together that belong together or are
useless one without the other.
You may then wish that only the first of the linked files
---------------------------------------------------------------------------
ARV -32- (c) Dirk Wriedt '91-'94
(the "primary file") should be displayed in the ARV lists.
zeigeverbund off
does exactly this.
Use <Shift-Tab> to change the display mode temporarily.
──────────────────────────────────────────────────────────────────────────
Note:
─────
Some of the above options require a DOS command. You may specify there
anything you could type at the DOS prompt. The current directory may be
changed, ARV will change it back afterwards.
paths should not be longer than 80 characters.
colours
───────
ARV's display colours may be changed.
This is done along with the configuration in ARV.CFG.
Each colour is set with
colour_option_name=number
where number is one of the following:
0=black 1 = blue 2 = green 3 = turquois 4 = red 5 = magenta 6 = brown
7 = light gray 8 = dark gray 9 = light blue 10 = light green
11 = light cyan 12 = light red 13 = light magenta 14 = yellow
15 = white
any colour + 128 = flashing colour
background colours are limited to 0..7.
The coour options are:
hintergrund background colour. This options should be set
first. This one overwrites all other background
colours but meldung_hg.
rahmenfarbe border colour
listenfarbe lists, misc. text
listenfarbe_cursor lists, highlighted text (cursor)
listen_cursor_hg lists, highlighted text (cursor) background
menue_farbe menu colour (the two lines near the bottom)
verz_grund directory display : misc files
verz_cursor " : cursor
verz_cursor_hg " : cursor background
verz_verz " : directories
verz_mark " : marked files
verz_cmark " : cursor on marked file
verz_cmark_hg " : " background
fehler_farbe error messages (error display line)
info_farbe info line colour (below error display line)
buchstaben_menue highlighted letters in menu
---------------------------------------------------------------------------
ARV -33- (c) Dirk Wriedt '91-'94
buchstaben_verb "linkage" letters in directory display
ergebnis_prima "Files addition results:": "good" files
ergebnis_mist " : "bad" files
ftastenzeilea first colour of function key display (bottom line)
ftastenzeileb second colour
ftastenzeilea_hg background colours
ftastenzeileb_hg "
hilfe_hg help background
hilfe_rahmen help border colour
hilfe_text help misc. text
hilfe_text2 help highlighted text 1
hilfe_text3 help highlighted text 2
stata_text statistics text 1 ***
statb_text statistics text 2
stata_hg background colours
statb_hg
meldung border & text pop-up windows
meldung_hg background pop-up windows
By setting the cursor-background colour to a different one than
the "hintergrund" colour, you get a "bar" colour.
If you are using a monochrome display, you should use the settings
in MONOCHRO.CFG, i.e. add the options given there to you ARV.CFG.
If you are using a hercules graphics card, you will have to find
the colour settings for yourself.
6.2. ARVNEU.CFG and ARVNEUx.CFG files
─────────────────────────────────────
... where x is a number 1..9.
As explained in chapter 6.1. option "nach_aufnahme", ARV creates
a textfile named AUFNAHME.TXT before executing the nach_aufnahme
command.
By default, AUFNAHME.TXT looks like this:
TSRROT2.LZH 3965 16.07.90 TP-Source: TSR fuer ROT-13-Screencodierung
X00V130J.ARJ 102378 14.07.91 Fossil-Treiber
Each line contains the file's name, size, date and comment.
All partitions will use this file layout, you may define different
file layouts for every partition, though. This is done through
ARVNEU.CFG or ARVNEUx.CFG.
Before creating the AUFNAHME.TXT file, ARV sees if a file named
ARVNEU.CFG or ARVNEUx.CFG (x=1..9) exists. ARVNEU.CFG if the
current partition is the primary one, ARVNEUx.CFG with x=partition
number otherwise.
ARVNEU.CFG or ARVNEUx.CFG look similar to ARV.CFG, but without the
[ARV] marker.
---------------------------------------------------------------------------
ARV -34- (c) Dirk Wriedt '91-'94
Valid options are:
BEFEHL <DosCommand>
─── changes the command set by nach_aufnahme.
MAXLAENGE <MaxLaenge>
─── sets the maximum line length to <MaxLaenge> characters. All lines
will be cut to that length.
DATEI <FileName>
─── specifies that <FileName> should be used instead of AUFNAHME.TXT.
TITEL <Header line>
ZEILE <file info line>
Each of these two options may apper up to five times.
TITEL describes text lines written at the beginning of AUFNAHME.TXT.
The ZEILE lines will be written to AUFNAHME.TXT for each file.
And, the most important thing, the following macros can be used:
$$ : a $ character [1]
$T : current date: Day [2]
$M : current date: month [2]
$J : cuurent date: year [2]
$P : name of partition [60]
$F : file name * [12]
$S : file size * [7]
$I : file size/1024 * [4]
$D : disk id * [20]
$A : disk storage * [10]
$G : group name (long name) * [40]
$Z : short group name * [8]
$K : file comment * [79]
$U : ("T"+1) file date : day * [2]
$N : ("M"+1) file date : month * [2]
$Y : file date : year * [2]
$L : lots of spaces [79]
The field length is given in brackets []. Any field will be filled with
spaces up to this length.
Each macro can be followed by [], [number], [x] or [number,x], where
x=L R or Z:
[] do _not_ fill with spaces. Each macro will occupy exactly
as much space as the text it represents.
[number] change field length to number
[Z] centers the text
[R] outputs the text right-aligned (default for $S)
[L] outputs the text left-aligned (default for all others)
[number,x] to combine length and alignment
Examples:
ZEILE $F[30,Z]
will center the file name within a field 30 characters in length.
ZEILE $F $S $U.$N.$Y $K
outputs file name, size, date and comment in table form:
---------------------------------------------------------------------------
ARV -35- (c) Dirk Wriedt '91-'94
TSRROT2.LZH 3965 16.07.90 TP-Source: TSR fuer ROT-13-Screencodierung
X00V130J.ARJ 102378 14.07.91 Fossil-Treiber
ZEILE $F[] $S[] $K[]
outputs file name, size, date and comment without filling spaces:
TSRROT2.LZH 3965 16.07.90 TP-Source: TSR fuer ROT-13-Screencodierung
X00V130J.ARJ 102378 14.07.91 Fossil-Treiber
Try it!
6.3. Automatic group selection - AUTOGRP.CFG / AUTOGRPx.CFG
───────────────────────────────────────────────────────────
ARV can save you lots of time when adding new files to the ARV system
by proposing you a group to put a new file in. Quite often, files have
already comments assigned to them that lead to the appropriate group
or the file extension gives a clue where the file is gonna go.
In these cases, ARV can preset the group selection cursor to the correct
group, and all you have to do is confirm it by pressing return.
The files controlling this feature are
AUTOGRP.CFG
or AUTOGRPx.CFG
respectively, AUTOGRP.CFG for the primary partition, AUTOGRPx.CFG, where
x=1..9, for the other partitions.
These files look like this:
:MODs
.MOD
:GIFs
.GIF
:ZyXEL
Zyxel
ZFAX
To make it clear:
The short name of any group is preceded by a colon ":". It is followed by
any number of lines containing text to be searched for in the file name
and description. As soon as the search is satisfied, it is ended and
the corresponding group will be proposed for this file.
AND condition.
If any line ends with a \ (backslash), the following text also has to be
in the file name & comment cobination. If the next line also ends with a
\, the line following that one, too, etc.
The following example will assign files to the group Animals which have
".GIF" in file name or comment as well as "animal":
:Animals
.GIF\
animal
Negation.
---------------------------------------------------------------------------
ARV -36- (c) Dirk Wriedt '91-'94
By a "!" at the start of any line, the text will be inhibiting the
group assignment.
Example:
:Games
game\
!VGA
Will put all file with "game" in file name or comment into the "Games"
group, excluding files with "VGA" in their name or comment.
Upper- and lower case is ignored in AUTOGRP.CFG.
You may include comments starting with "*" or ";", but not in a row of
"AND" conjunctions:
* put all pascal sources into PASCAL group
:pascal
.PAS
* all over-18 GIFs SexyGif
:sexygif
sex\
.GIF
* all other GIFs to the miscgif group
:miscgif
.GIF
etc.
---------------------------------------------------------------------------
ARV -37- (c) Dirk Wriedt '91-'94
┌─────────────────────────────────────────────────────────────────────────┐
│ 7. The ARV environment variable, ARVRES environment variable │
└─────────────────────────────────────────────────────────────────────────┘
By default,
ARV expects ARV creates
ARVCOPY.EXE *.ALL
ARV.CFG *.DIF
FILES.AR? AUFNAHME.TXT
DISKS.AR?
GROUPS.AR?
SYS.AR?
ARV.HLP
*.ALL
*.DIF
ARVNEU*.CFG
AUTOGRP*.CFG
ARV.OVR
ARV.RES
in the same directory as ARV.EXE.
If the ARV environment variable exists, e.g. by setting it with
SET ARV=c:\2ND_ARV
ARV will expect
ARVCOPY.EXE
ARV.HLP
ARV.OVR
ARV.RES
in the same directory as ARV.EXE, as before
ARV expects ARV creates
ARV.CFG *.ALL
FILES.AR? *.DIF
DISKS.AR? AUFNAHME.TXT
GROUPS.AR?
SYS.AR?
*.ALL
*.DIF
ARVNEU*.CFG
AUTOGRP*.CFG
in the directory pointed to by the ARV environment variable. In this way,
you may have several independant ARV systems installed without having
multiple copies of the executables files. See chapter 10 for further
description on how to use this feature.
ARV.RES underlies further special treatment.
This file is needed by all .EXE files but ARVCOPY.EXE. These programs
all look for ARV.RES in the directory they reside in. For example,
if you execute c:\arv\arvexpo.exe, ARVEXPO will look for c:\arv\ARV.RES.
---------------------------------------------------------------------------
ARV -38- (c) Dirk Wriedt '91-'94
This should be the normal case. If any .EXE file have to be put elsewhere,
away from ARV.RES, you have two possibilities:
a) You copy ARV.RES to the respective directory for each .EXE file.
b) You set the ARVRES environment variable to point to ARV.RES,
e.g. SET ARVRES=c:\arv\arv.res. The file name has to be included.
If you want to use both the german and the english ARV Version,
use either
set arvres=c:\arv\deutsch.res
or set arvres=c:\arv\englisch.res
after you have copied arv.res from the english ARV version to
englisch.res and the arv.res file from the german ARV version to
deutsch.res.
The english and german language kits are available seperately from where
you got ARV from, ARVxxxEL.ARJ and ARVxxxDL.ARJ respectively.
---------------------------------------------------------------------------
ARV -39- (c) Dirk Wriedt '91-'94
┌─────────────────────────────────────────────────────────────────────────┐
│ 8. License agreement/thanks │
└─────────────────────────────────────────────────────────────────────────┘
8.1. DISCLAIMERS
────────────────
I DISCLAIM ANY WARRANTIES, EXPRESS OR IMPLIED, ORAL OR WRITTEN, INCLUDING
ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
PURPOSE. IN NO EVENT SHALL I BE LIABLE FOR ANY INCIDENTAL, CONSEQUENTIAL,
OR PUNITIVE DAMAGES WHATSOEVER ARISING OUT OF USE OF THE PROGRAM OR YOUR
RELATIONSHIP WITH ME.
I have thoroughly tested ARV, and as far as I can judge and from
experience, it is safe in operation.
If you do not agree to these conditions, you may not use ARV.
8.2.Registration
────────────────
ARV is neither public domain nor freeware, but Shareware.
It took me quite a long time to make ARV run at first, and it took
even more time to make it run properly. Every improvement takes much
time and energy. Writing the english documentation file took a whole
lot of time, too.
This is why I command that everyone using ARV more than three months
has to register himself for doing so. This provides positive feedback
for me (why should I invest time in something noone uses) and is
considered to be as appreciation from you.
Becoming a registered ARV user in not diffucult nor expensive. Just
send in the registration form. See register.txt.
ARV may not be used in a commercial environment.
Being registered, you may use the file swapping function and create
partitions within you ARV system. You can not do that with unregistered
ARV.EXE versions. I don't restrict ARV that way to make you register, but
for the files swapping function, a serial number is needed, and using
the partitioning concept, you can overcome the evaluation period.
I hope that ARV will prove itself useful to as many people as possible.
Me, that is:
Dirk Wriedt, Kirsebek 15, D-24376 Kappeln, Germany
Electronic-Mail :
Fido Address : 2:240/2120.8
Internet : dirkw@toppoint.de
As of: 1.12.94
I invite you to send feedback, improvent tips and bug reports. I always
try to give respect to your hints as far as possible.
You may order the latest version of ARV using the update.txt order
---------------------------------------------------------------------------
ARV -40- (c) Dirk Wriedt '91-'94
form.
---------------------------------------------------------------------------
ARV -41- (c) Dirk Wriedt '91-'94
8.4. Program protection/evaluation period
─────────────────────────────────────────
ARV is Shareware, that means it has the great advantage that you
can try it before you buy it and you know exacty what you are going
to buy.
Whoever uses this program longer than the evaluation period of 90 days
should have made his mind up wether ARV is of use to him or not. In
the latter case, he should stop using ARV. If ARV proves to be useful
to him, he should take the effort and register it. ARV is very cheap.
Of course, some people don't see this. To force these people to
register ARV,
- ARV will stop working after three months of usage.
- ARV will stop working after the 600th run.
ARV will not destroy data after the evaluation period has expired.
It will simply stop running.
You can determine the time left at any time; it is shown on the
"Statistics" page shown by F2.
The evaluation period begins as you run ARV for the first time on
"untouched" .ARV files, i.e. the ones in the ARV package or files
freshly created using RESETARV. If you want to check things out and
play a little around, you should use RESETARV before you are really
archiving your files to be sure to have the full three months of
evaluation period left.
Remember to send in the registration form at least three weeks before
the evaluation period expires, so that you can continue using your
.ARV files without interruption.
As soon as you have got your key, you can proceed working with ARV.
NOTE:
Your ARV files may take damage if you try to manipulate ARV.EXE.
---------------------------------------------------------------------------
ARV -42- (c) Dirk Wriedt '91-'94
8.5. The ARV data file format
─────────────────────────────
... is not secret.
If you would like to develop tools for ARV or programs using the ARV
data files, as for example, Thorsten Drewes has done with ARVDIR,
please contact me.
I do not enclose this information here, as I would like to know about
who is doing what. You don't hear much from your users, you know ;-)
8.6. A whole lot of credits go to
─────────────────────────────────
Thorsten "Toddl" Drewes
for lots of good ideas and really pushing ARV. Thorsten did the routines
for the VGA lines detection, the really nice pictures of the disks, the
ARV logo and ---> ARVDIR <---. You should really try it.
Peter Langhans
for his good thoughts and criticism.
Arnd-Henning "AHA" Siebs
who had the idea of the built-in cache (I would not have believed the
speed improvement)
Kai Ackermann
for being a good beta-tester.
Michael Rittweger
for spreading the ARV word and the program through his Fido mailbox
BLIZZARD 2:240/2120.
Jens Mueller
for spreading ARV over the whole world and who handles the payment by
credit card for me
Helge Sjoestroem
who turned out to be the 1.34 reference beta tester
The swapping is done using the EXECSWAP unit by TurboPower Software
(c) 1988. I am using the version patched by Bill Burleigh & Rich Cromer.
Thanks a lot for these powerful procedures.
---------------------------------------------------------------------------
ARV -43- (c) Dirk Wriedt '91-'94
┌─────────────────────────────────────────────────────────────────────────┐
│ 9. Registering ARV │
└─────────────────────────────────────────────────────────────────────────┘
Upon your ARV registration, you will receive the file ARV.REG which
consists of three text lines and may thus be transmitted via e-mail or
by voice, too.
ARV.REG has to be copied into the same directory as ARV.EXE.
Then, run REGARV (no parameters). REGARV will ask you for the key's
password. This is the password needed to validate this key. You only
need this password if you have given one on your registration form. If you
don't have any password, just press <Enter>.
The hard disk will be busy for 30-50 secs. Afterwards, ARV.EXE will be
branded with the data in ARV.REG. REGARV will end up with "successful"
if it was able to brand ARV.EXE.
Using this ARV.REG file, all further ARV-Versions can be registered, so
keep it well!
Of course, you may NOT give copies of ARV.REG to others.
---------------------------------------------------------------------------
ARV -44- (c) Dirk Wriedt '91-'94
┌─────────────────────────────────────────────────────────────────────────┐
│ 10. Partitions │
└─────────────────────────────────────────────────────────────────────────┘
Although ARV allows you to group your files comfortably using the ARV
Groups, you may meet the need for a more coarse division of your files.
You have two possibilities to do that.
a) Creation of two directories, one for one set of data files and
the ARV executables, and one for a different set of data files.
In fact, you may create an arbitrary number of data directories.
Then, set the ARV environment variable accordingly to the
directory the data you wish to use resides in.
That means
- you will have different ARV.CFG files for each data
directory
- you will have different .ALL-files (see chapter 4.) for
each data directory.
b) Create another partition in the ARV directory you are using
anyway.
Now, what is a "partition"?
Normally, the ARV data files are named "FILES.ARV", "DISKS.ARV",
"GROUPS.ARV" and "SYS.ARV".
In the same directory, you may create nine other sets of
data files. Any set of data files is called a partition.
The partition which uses *.ARV files is called the
"primary partition", all other partitions use *.ARx files, where
x is a number from 1 to 9. That means, each partition consists of
the data files FILES.ARx, DISKS.ARx, GROUPS.ARx and SYS.ARx, with
the partition number being x. For x=0, the primary partition,
ARV files are used.
You may create a new partitions in two ways:
copy another partition, e.g. with
copy *.ARV *.ARV2
will create a new partition (partition #2).
use RESETARV, which will create an empty partition:
RESETARV /3
will create empty FILES.AR3, DISKS.AR3, GROUPS.AR3 and SYS.AR3
files.
When you run ARV, you will see the primary partition. You can
switch between partitions by pressing "p" in the Group List.
Non-existent partitions will be described "free partition". All
other partitions are displayed by their description. Using
CTRL-B, you can enter a description for the currently highlighted
partition. As you call this menu for the first time, ARV will
create a file named PARTINFO.ARV which will hold the descriptions
for all your ARV partitions.
Using of the partitioning principle will result in
- same ARV.CFG file for all partitions
- same .ALL file for all partitions.
You may even combine methods a) and b). This is for advanced users only,
you may easily get confused...
---------------------------------------------------------------------------
ARV -45- (c) Dirk Wriedt '91-'94
b) may only be done by registered users. Sorry.
PLEASE NOTE
In both cases, a) and b), any ARV partition or data file set is
totally independent of all others.
That means, ARV can NOT distinguish wether any disk belongs to the
currently active partition or not. The DISK.ID disk identifying
files on the ARV disks do not specify the partition the disk belongs to.
KEEP THAT IN MIND
or you will get in trouble...
However, it's not as dangerous as it sounds ...
---------------------------------------------------------------------------
ARV -46- (c) Dirk Wriedt '91-'94
┌─────────────────────────────────────────────────────────────────────────┐
│ 11. The ARV_OPTI and ARV_SOS tools │
└─────────────────────────────────────────────────────────────────────────┘
11.1. ARV_OPTI
──────────────
The more files, disks or groups are active on you ARV system, the
longer the mean data record access time gets. The cause is that,
the larger your .ARV data files get, the more seeks have to be done
when accessing the records in alphabetical order. The data files get
more and more "out of order". To add to that, deleted records become
"holes" which have to be skipped over.
ARV_OPTI can cure this for the FILES.ARV and GROUPS.ARV files. ARV_OPTI
can physically sort the records in these data files, making access in
alphabetical order *very* fast. Using a write-behind disk cache will
ARV_OPTI very quick in optimizing your files, so do it as often as you
like.
The DISK.ARV file may not be optimized, because the DISK.ID files
directly point to the disk's record number in DISKS.ARV. In an early
ARV_OPTI version, I overlooked that, and one of my beta-testers had
to re-add all his ARV disks...
Try ARV_OPTI without any parameters to see how it works.
11.2. ARV_SOS
─────────────
Of course, ARV is not bug-free. I am keeping great care in making sure
that, at all times, a crash of your computer (whether it was ARV's fault
or not) will not result in serious damage to your ARV data files. Really.
However, we all know: it will happen that the data files will get corrupt
some way, and ARV will display nonsense. This is what ARV_SOS is for.
ARV_SOS will correct the data files' size, check all of the internal
references between files, disks & groups and will completed rewrite
all this information.
PLEASE make back-up copies of all your data files of the partition to
optimize. You never know...
Run ARV_SOS without any parameters to see instructions.
NOTE:
After using ARV_SOS or ARV_OPTI, ARV will have to re-create some tables,
so the first run of ARV will take a *bit* longer.
Please have patience...
---------------------------------------------------------------------------
ARV -47- (c) Dirk Wriedt '91-'94
┌─────────────────────────────────────────────────────────────────────────┐
│ 12. Questions & Answers │
└─────────────────────────────────────────────────────────────────────────┘
Q: How may files can be marked for retrieval, deletion... ?
A: Up to 1000 files may be marked at any time.
Q: I would like to retrieve more files than will fit on the
(floppy) disk I want them to be copied to.
A: ARV does not (yet) support that. Please retrieve the files to
your hard disk, and copy them to floppy disk afterwards.
Q: I would like to move a file from one group to another.
A: Use "retrieval with deletion".
Retrieve the file to your hard disk, then re-add it to the other
group. To move a whole disk to another group, remove it using
one of the disk special functions, then add the whole disk to
ARV.
Q: I have a whole disk full of files that I want to add to my
ARV catalogue system. All files may be included in the same group.
A: Please use the "add whole disk" function. Try CTRL-F10 in the
"Groups" list. See chapter 5.4..
Q: Alt-... does not work anymore in a list, or jumps to the
wrong place.
A: One of ARV's index files is corrupt. Run ARV /i to make ARV rebuild it.
Run ARV /i /<PartNr> for any other partition than the primary one.
Q: How do afx_verz and files_bbs options work together?
A: The directories given by afx_verz options will be searched first.
Simply, because .AFX files can be searched much faster.
Q: I have FIDO net access and need the text format file lists
additionally to the .AFX style list to be able to make FIDO file
requests.
A: To save time & space, use AFXREQ. This is a fast & neat file
request program which creates.MSG request files and makes use of
the .AFX files. Try it! Magic AFXREQ at 2:240/2120. Or see
the box you got ARV from...
Q: F1 does nothing.
A: Three possibilities:
a) the file ARV.HLP is not in the same directory as ARV.EXE.
b) the tempdir directory does not exist.
c) there is no help at this point.
Try F1 just after starting ARV. In the group list, there IS help
available.
Q: Oh no! My computer crashed and the ARV data seems corrupt now!
A: Read chapter 11 and try ARV_SOS.
Q: What is FIDO? What do these numbers like 2:210/3783 etc
mean?
A: Remain calm. The FIDO(tm) net is a world-wide net of electronic
mailboxes who communicate via modem. People discuss almost everything
in the public "AREAS" or send private NETMAIL to each other.
Worth considering for you, too :-) ARV does support FIDONet members
using the files_bbs option.
---------------------------------------------------------------------------
ARV -48- (c) Dirk Wriedt '91-'94
Q: What the hell does "F1" in the upper left corner tell me?
A: Stupid question. Try and press it! "F1" means "here is help available".
Altough no F1 appears in the standard lists, help _is_ available.
Q: My registration key does not work!
A: Please note that your name is case-significant, as well as the
third text line of the key.
Your name is written in the same way you wrote it on the registering
form. German "Umlaute" or other special characters may have gone
lost or being malformed if transferred electronically. You will
have to correct this by hand.
---------------------------------------------------------------------------
ARV -49- (c) Dirk Wriedt '91-'94
┌─────────────────────────────────────────────────────────────────────────┐
│ 13. Error codes │
└─────────────────────────────────────────────────────────────────────────┘
Not all error messages are issued in plain text format. Maybe, this will
change one day, but a lot of errors, especially the fatal ones, are
described by one to three error codes explaining what happened any
why it did happen.
Error code
0 no description available
2 file not found
3 path not found
4 too may files open
5 file access denied
6 invalid file pointer
12 invalid access mode
15 invalid drive number
16 current directory may not me removed
17 attempt to rename across drives
100 read error
101 write error
102 file not assigned
103 file not open
104 file not open for reading
105 file not open for writing
106 invalid numeric format
150 disk write proteced
151 unknown device
152 drive not ready
153 unknown command
154 checksum error
155 invalid disk parameter block
156 error in sector
157 unknown format
158 sector not found
159 printer out of paper
160 write error on device
161 read error on device
162 hardware error
Error codes from 200 to 1999 will result in ARV to
terminate.
200 division by zero
201 range check error
202 stack underflow
203 heap overflow
204 invalid pointer operation
205 floating point overflow
206 floating point underflow
207 floating point general error
208 overlay manager not installed
209 I/O error while reading overlay file
1001 ARV interal error: The primary partition could not be
---------------------------------------------------------------------------
ARV -50- (c) Dirk Wriedt '91-'94
re-opened to write checksums.
1002 DISK.ID file of ARV disk could not be opened
1003 DISK.ID file could not be read from
1004 requested ARV partition (through /0../9) could not be opened.
1005 the ARVAKTIV.SEM file could not be deleted. The second
error code tells you, why.
1006 despite ARV got enough free memory space from DOS,
it could not be allocated for heap variables.
1008 when rewriting .ALL file:
neither the originally active nor the primary partition
could be opened after rewriting the .ALL file. The second
error code refers to the error while opening the original
partition, the third one tells you why opening the
primary partition failed.
2001-2255 partition could not be opened.
this error code adds up from the error codes of multiple
possible errors. These errors do have the values:
1 FILES.ARx does not exist
2 DISKS.ARx does not exist
4 GROUPS.ARx does not exist
8 SYS.ARx does not exist
16 GROUPS.ARx could not be opened
32 DISKS.ARx could not be opened
64 FILES.ARx could not be opened
128 SYS.ARx could not be opened
2256 On error has occured while trying to delete a file
from the temporary directory. The second error code
gives the reason why.
3000-3256 ARVCOPY.EXE error. The last three digits tell you
why ARVCOPY failed:
30 no buffer memory
31 source file could not be accessed
32 target file could not be accessed
33 source file not found
34 read access denied
35 read access: invalid file handle
36 write access denied
37 write access: invalid file handle
38 source file size could not be determined
if the last three digits are out of this range, see
other error codes.
Possible causes of some errors
5 maybe a file is write protected which should not
be?
Should ARV terminate due to a runtime error, the file ARVAKTIV.SEM might
not be deleted. Please read chapter 5.11. on this topic.
---------------------------------------------------------------------------
ARV -51- (c) Dirk Wriedt '91-'94
┌─────────────────────────────────────────────────────────────────────────┐
│ 14. command line parameters │
└─────────────────────────────────────────────────────────────────────────┘
ARV does recognize these parameters:
/0 .. /9 choose the partition to be opened initially
/i makes ARV rebuild the ALT-x letter index of the chosen partition
if this index is corrupt, the ALT-x jump may not function,
or new files, disks or groups may be not inserted properly.
---------------------------------------------------------------------------
ARV -52- (c) Dirk Wriedt '91-'94
┌─────────────────────────────────────────────────────────────────────────┐
│ 15. System requirements │
└─────────────────────────────────────────────────────────────────────────┘
MS-DOS 3.20 or later
hard disk with at least 2MB of free space (for the executable files)
at least one floppy drive
350k of free lower memory
8086 processor or later ;-)
Strongly recommended:
hard disk cache
EMS memory
---------------------------------------------------------------------------
ARV -53- (c) Dirk Wriedt '91-'94
┌─────────────────────────────────────────────────────────────────────────┐
│ Index │
└─────────────────────────────────────────────────────────────────────────┘
*.ARV .................................................. 16
.AFX ............................................... 18, 25
.ALL ............................................... 26, 45
.ALL-files ............................................. 11
.DIF ................................................... 11
17 cpi ................................................. 20
4DOS ................................................... 10
4DOS style comment ..................................... 10
<Shift-Tab> ............................................ 7
access time ............................................ 47
Ackermann, Kai ......................................... 43
add a whole disk ....................................... 14
add new files to ARV ................................... 8
AFXREQ ................................................. 48
afx_verz ............................................... 18
alternative_liste ...................................... 18
altf ................................................... 18
ARV .................................................... 5
ARV data file format ................................... 43
ARV environment variable ........................... 38, 45
ARV hangs .............................................. 13
ARV.CFG ............................................ 17, 45
ARV.RES ................................................ 38
ARVAKTIV.SEM ........................................... 16
ARVDIR ................................................. 17
arvival of new files ................................... 8
ARVRES environment variable ............................ 38
ARV_OPTI ............................................... 47
ARV_SOS ................................................ 47
Attributes ............................................. 9
AUFNAHME.TXT ....................................... 28, 34
auswurf ................................................ 20
AUTOGRP.CFG ............................................ 36
Automatic group selection .............................. 36
belegung_bequem ........................................ 20
Best fit ............................................... 31
capacity ............................................... 13
colours ................................................ 33
command line parameters ................................ 52
comments display ....................................... 7
CompFLS ................................................ 25
COMPFLS.EXE ............................................ 18
condcode ............................................... 20
condensed print ........................................ 20
cond_zeichen ........................................... 20
configuration files .................................... 17
credits ................................................ 43
dateien_vergleich ...................................... 11
datei_vergleich ........................................ 20
delete disk ............................................ 14
DESCRIBE command ....................................... 10
describe_arv ........................... 10, 14, 21, 26, 27
describe_geholt .................................... 10, 21
descript.ion ................................... 10, 21, 26
directvideo ............................................ 22
disk - flags ........................................... 9
---------------------------------------------------------------------------
ARV -54- (c) Dirk Wriedt '91-'94
disk check ............................................. 13
Disk List .............................................. 7
disk selection strategy ................................ 31
DISK.ID .................................... 6, 14, 46, 47
dkf .................................................... 22
doppelt_version ........................................ 22
DOS command ........................................ 31, 33
Drewes, Thorsten ....................................... 43
druckerport ............................................ 23
druckertest ............................................ 23
druckinit .............................................. 23
Error codes ............................................ 50
evaluation period ...................................... 42
EXECSWAP ............................................... 43
fbbs_descol ............................................ 24
festplatten ............................................ 24
FIDO ................................................... 48
FIDO net file request .................................. 48
file comment ........................................... 24
file flags ............................................. 9
File List .............................................. 7
file version checking .................................. 22
files_bbs .............................................. 24
First fit .............................................. 31
Flags .................................................. 9
form feed .............................................. 32
function keys ...................................... 18, 30
gesehen_liste ...................................... 11, 26
group list ............................................. 6
hercules graphics ...................................... 34
INSTALL ................................................ 5
Installation ........................................... 5
Introduction ........................................... 3
kommentaresofortschreiben .............................. 26
kommentarnachfrage ..................................... 26
lange_arv_kommentare ............................... 22, 26
lange_hol_kommentare ................................... 27
Langhans, Peter ........................................ 43
Last fit ............................................... 31
License agreement ...................................... 40
lindex_divisor ......................................... 27
line length ............................................ 30
link files ............................................. 32
linked files ....................................... 7, 8
linkerrand ............................................. 27
list displays .......................................... 6
lock/unlock disk ....................................... 14
lost ARV files ......................................... 13
LZEXE .................................................. 13
markbymail ............................................. 27
MarkByMail - function .................................. 15
maximum number of data file entries .................... 13
maximum number of marked files ......................... 15
maxzeilen .............................................. 27
MONOCHRO.CFG ........................................... 34
monochrome display ..................................... 34
Mueller, Jens .......................................... 43
nach_aufnahme ...................................... 27, 34
neu_datei_vergleich .................................... 28
neu_info_modus ......................................... 28
---------------------------------------------------------------------------
ARV -55- (c) Dirk Wriedt '91-'94
Notes .................................................. 13
number of marked files ................................. 15
other people's ARV files ............................... 16
PARTINFO.ARV ........................................... 45
Partitions ............................................. 45
performance index ...................................... 27
picacode ........................................... 20, 29
pica_zeichen ........................................... 28
PKLITE ................................................. 13
ppp_aufdisk ............................................ 29
primary file ....................................... 7, 33
primary partition ...................................... 45
printer connection ..................................... 23
printer line length ................................ 20, 29
Printing of this documentation ......................... 13
Questions & Answers .................................... 48
randoben ............................................... 29
re-read ARV data after system crash .................... 14
read free disk space ................................... 14
Registering ARV ........................................ 44
Registration ........................................... 40
registration key does not work ......................... 49
remove "marked" flag from all files .................... 14
remove disk ............................................ 14
RESETARV ............................................... 45
retrieval with deletion ................................ 48
rewrite comments ....................................... 14
Rittweger, Michael ..................................... 43
seitenlaenge ........................................... 30
selbegruppe ............................................ 30
serial number .......................................... 11
shiftf ................................................. 30
should anything go wrong ............................... 13
Siebs, Arnd-Henning .................................... 43
Sjoestroem, Helge ...................................... 43
special file functions ................................. 14
Special functions ...................................... 13
Speed .................................................. 13
standardverz ........................................... 30
strategie .............................................. 31
strategy ............................................... 31
SUBST .................................................. 24
swapping ............................................... 31
swapping files function ............................ 11, 26
swapping of files ...................................... 21
switch between partitions .............................. 45
System requirements .................................... 53
s_swapping ............................................. 29
TEMP directory ......................................... 5
tempdir ................................................ 17
temporary directory .................................... 17
thanks ................................................. 40
toddlkomm .............................................. 31
top margin ............................................. 29
TurboPower Software .................................... 43
turbo_files ............................................ 32
unmark all files ....................................... 14
virus protection ....................................... 13
ViruScan ............................................... 13
wartenachseite ......................................... 32
---------------------------------------------------------------------------
ARV -56- (c) Dirk Wriedt '91-'94
wartevorseite .......................................... 32
write DISK.ID .......................................... 14
zeigedatei ............................................. 32
zeigeverbund ........................................... 32
---------------------------------------------------------------------------
ARV -57- (c) Dirk Wriedt '91-'94